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CHAPTER 1 
INTRODUCTION 


This chapter introduces PRO/Tool Kit BASIC-PLUS-2 and shows how it 
fits into the Professional family of software. You should read this 
chapter first; then/ based on what you read here and on your current 
level of knowledge about the topics discussed, read elsewhere in the 
Professional documentation before you attempt to use PRO/Tool Kit 
BASIC-PLUS-2. 


This 


chapter discusses the following topics: 

• Section 1.1 introduces PRO/Tool Kit 
components. 


BASIC-PLUS-2 


and its 


• Section 1.2 previews the installation and verification 
procedures for PRO/Tool Kit BASIC-PLUS-2. 

• Section 1.3 lists the steps that you must follow to develop an 
application on the Professional. 




1.1 PRO/TOOL KIT BASIC-PLUS-2 

PRO/Tool Kit BASIC-PLUS-2 is a modified version of the BASIC-PLUS-2 
compiler and Object Time System (OTS). The BASIC-PLUS-2 resident 
library, BP2V23.TSK, provides run-time support for applications. 

The function and use of PRO/Tool Kit BASIC-PLUS-2 and BASIC-PLUS-2 on 
RSX are very similar; however, some important differences exist. 
These differences are discussed in detail in Chapter 4. 

In general, once you have installed the Professional Developer’s Tool 
Kit and PRO/Tool Kit BASIC-PLUS-2, you can use your Professional to 
develop BASIC-PLUS-2 applications that run on P/OS. 

The PRO/Tool Kit BASIC-PLUS-2 package includes the following 
components: 

• The PRO/Tool Kit BASIC-PLUS-2 Compiler 

• The PRO/Tool Kit BASIC-PLUS-2 Object Time System (OTS), which 
includes: 

— The PRO/Tool Kit BASIC—PLUS—2 Resident Libraries, 

BP2V23.TSK and BP2V23.STB 

- The PRO/Tool Kit BASIC-PLUS-2 Disk Library, BP20TS.0LB 

• The PRO/Tool Kit BASIC-PLUS-2 Help Files 

• The PRO/Tool Kit BASIC-PLUS-2 Resequencer 
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• The PRO/Tool Kit BASIC-PLUS-2 Error Message Files 

• The PRO/Tool Kit BASIC-PLUS-2 Overlay Descriptor Files (ODL) 

• The documentation 

- PRO/Tool Kit BASIC-PLUS-2 Installation Guide and 
Documentation Supplement 

- BASIC on RSX-ll/M-PLUS Systems 
BASIC Reference Manual 

- BASIC User 1 s Guide 

BASIC Pocket Reference Guide 


1.2 INSTALLATION AND VERIFICATION 

The PRO/Tool Kit BASIC-PLUS-2 compiler is distributed in the form of a 
prebuilt task image. This image is linked against the resident 
libraries, B23SHR.TSK and B23SH1.TSK. You cannot edit a command build 
file to tailor PRO/Tool Kit BASIC-PLUS-2 to your environment. 
Similarly, the Object Time System task is prebuilt and cannot be 
modified. Installation simply consists of copying files from the 
distribution volume to appropriate directories. 

If you want to modify the compiler to suit your system environment, 
you can preset compiler defaults using the compiler initialization 
file. Section 4.3 describes the initialization file in detail. 

Using files supplied during the installation of PRO/Tool Kit 
BASIC-PLUS-2, the Installation Verification Procedure (IVP) guides you 
through the creation of a sample PRO/Tool Kit BASIC-PLUS-2 application 
that verifies the installation. 


1.3 SUMMARY OF THE APPLICATION DEVELOPMENT PROCESS 

The development of an application requires a number of steps, some of 
which may have to be repeated in a cycle. The Tool Kit User 1 s Guide 
describes all these steps. 

Here is a list of steps you must follow; more detailed information is 
presented in Section 4.2. Additionally, the PRO/Tool Kit BASIC-PLUS-2 
verification application, which is described in Chapter 3, guides you 
through the following steps: 

1. Writing the source program 

2. Compiling the source program 

3. Generating the command and overlay descriptor files 

4. Building the P/OS task image 

5. Running and debugging the task image 

6. Writing the application installation file 

7. Installing, running, and debugging the application 

8. Creating the final diskette 
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CHAPTER 4 


DEVELOPING THE APPLICATION 


This chapter supplements the BASIC on RSX-11M/M-PLUS Systems manual 
and is intended for programmers experienced with BASIC-PLUS-2 on RSX 
systems. For complete information about developing BASIC 
applications, see the other manuals included in the PRO/Tool Kit 
BASIC-PLUS-2 documentation set. The sections in this chapter provide 
the following information: 

• Section 4.1 summarizes the differences between PRO/Tool Kit 
BASIC-PLUS-2 and BASIC-PLUS-2 on RSX. 

• Section 4.2 explains each of the steps that you need to 
perform to develop an application using PRO/Tool Kit 
BASIC-PLUS-2. 

• Section 4.3 explains how you can preset compiler defaults for 
PRO/Tool Kit BASIC-PLUS-2, using a compiler initialization 
file. 

• Section 4.4 describes and lists PRO/Tool Kit BASIC-PLUS-2 
run-time error messages. 


4.1 DIFFERENCES BETWEEN PRO/TOOL KIT BASIC-PLUS-2 AND BASIC-PLUS-2 ON 
RSX 

For the most part, the function and use of PRO/Tool Kit BASIC-PLUS-2 
and BASIC-PLUS-2 on RSX are very similar; however, some important 
differences exist. These differences are summarized in the next 
section. 


4.1.1 Differences and Unsupported Features 

Table 4-1 summarizes items that you must consider when you write 
PRO/Tool Kit BASIC-PLUS-2 applications. Some of the items in the 
table are features that operate differently than on RSX systems, 
others are not supported. Do not use the unsupported features when 
you write PRO/Tool Kit BASIC-PLUS-2 applications. 
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Table 4-1: PRO/Tool Kit BASIC-PLUS-2 — Differences 
and Unsupported Features 


Feature 

Please Note 


Compiler Commands 


RUN 

This command is not available in the 
Tool Kit compiler. 

LOAD 

This command is not available in the 
Tool Kit compiler. 

BUILD 

There are differences between the CMD 
and ODL files created by PRO/Tool Kit 
BASIC-PLUS-2 and PDP-11 BASIC-PLUS-2 
on RSX systems. 

BUILD/DUMP 

This command is unsupported. 

BUILD/NOSEQUENTIAL 

This command is unsupported for 

programs that do not access RMS files. 

SET DUMP 

This command is unsupported. 

SET NOSEQUENTIAL 

This command is unsupported for 

programs that do not access RMS files. 


Debugger Commands 


REDIRECT 

This command allows debugging during 
application execution from a terminal 
attached to the Professional. It does 
not accept a terminal device number. 

Error Messages 1 

* 

The Tool Kit compiler error messages 
are a subset of BASIC-PLUS-2 on RSX 
error messages. You must press RESUME 
to continue after receiving an error 
message. Note that error number 135 
is issued if you attempt indexed I/O 
on a P/OS Diskette application (as 
opposed to a P/OS Hard Disk 
application). 

Immediate Mode 

Immediate mode is not available in the 
Tool Kit compiler. 

$ Command 

Supported for RSX-11M/M-PLUS systems 
only (not VMS). 

Magnetic Tape Operations 

Magnetic tape operations are 

unsupported. 


!• For a complete list of PRO/Tool Kit BASIC-PLUS-2 error messages, 
see Section 4.4, 

(Continued on next page) 
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Table 4-1 (Cont.): 

PRO/Tool Kit BASIC-PLOS-2 — Differences 
and Unsupported Features 

Feature 

Please Note 

RMS Support 

Magnetic tape operations are 

unsupported. 

Statements 

CHAIN 

CHAIN accepts as an argument the 
installed task name, which is the same 
name used in the application 
installation file. CHAIN does not 
accept the file name of the task 
image. 

EDIT$ Function 

You cannot use an odd integer as the 
argument to EDIT$ if the string to be 
operated on contains an 8-bit 
character. If you do, the high-order 
bit for that character is cleared. 

TIME$ Format 

The twelve-hour AM/PM format for the 
TIME$ function is unsupported. 

CTRL/C Trapping 

Enabling CTRL/C trapping causes the 
terminal to be attached. Some of the 
callable P/OS routines cannot be 
called if the terminal is attached 
(see the Tool Kit User's Guide). 

DECnet File Access (DAP) 

This feature is unsupported. 


4.1.2 Character Sets 

PRO/Tool Kit BASIC-PLUS-2 supports the 8-bit DEC Multinational 
Character Set in string literals, comments, and DATA statements when 
you compile an application, and as input or output when you run the 
application on the Professional. (See the Terminal Subsystem Manual 
for a description of the DEC Multinational Character Set.) 

The PRO/Tool Kit BASIC-PLUS-2 compiler does not allow European 
alphabetics in variable names. 

If the string to be operated on contains an 8-bit character, do not 
use any odd integer as the argument to the EDIT$ function. If you do, 
the high-order bit for that character is cleared. 


4.2 DEVELOPMENT CYCLE 

This section explains each of the steps you need to perform to develop 
an application using PRO/Tool Kit BASIC-PLUS-2. Note, however, that 
the descriptions in this chapter are restricted to aspects of the 
development process that are unique to PRO/Tool Kit BASIC-PLUS-2. 
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The development cycle for PRO/Tool Kit BASIC-PLUS-2 applications 
(Figure 4-1) consists of the following steps: 

1. Writing the source program 

2. Compiling the source program to create an object module file: 

• Compiling with /DEBUG to debug at run time 

• Compiling without /DEBUG when the program is error free 

3. Generating the command and overlay descriptor files 

4. Building the P/OS task image 

5. Running and debugging the task image file 

6. Writing the application installation file 

7. Installing, running, and debugging the application 

8. Running the Application Diskette Builder, when the program is 
error free, to create the final diskette 

The following sections present specific details of application 
development with PRO/Tool Kit BASIC-PLUS-2. For a complete 
description of each stage in Tool Kit application development, refer 
to the Tool Kit User 1 s Guide . Also note that, with the Tool Kit, you 
can create application diskettes that can run on P/OS Diskette, on 
P/OS Hard Disk, or on both. This document focuses on application 
development for the P/OS Hard Disk environment. Some important 
differences in the application development cycle for these two 
environments exist. Refer to the Tool Kit User's Guide for full 
details. 


4.2.1 Writing the Source Program 

You can create a BASIC source program by entering text in the BASIC 
environment or by using any text editor available on the Professional. 
Refer to the appropriate text editor manual for more information. 

Your PRO/Tool Kit BASIC—PLUS-2 source program can include external 
subroutine calls to access P/OS facilities from your program. The 
external subroutine calls are described in the Tool Kit User's Guide 
and the CORE Graphics Library Manual . P/OS facilities exist in the 
following areas: 

1. P/OS user interface support — Your application has access to 
P/OS menu, help, message, and other system services. The 
ability to display error messages, status, online help, and 
menus on the screen is provided through the P/OS Service 
Routines Library (POSRES). 

2. Extended software functions — Your application can invoke 

callable system services, such as PROSE (the P/OS text 
editor) and PRO/Communications (the Professional 

communications facility). 

3. Bitmap graphics routines — Your application has access to 
the graphics routines in the CORE Graphics Library. 

P/OS facilities are accessed through the register 5 (R5) calling 

sequence with the PRO/Tool Kit BASIC-PLUS-2 CALL BY REF statement. 


I 
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Figure 4-1: PRO/Tool Kit BASIC-PLUS-2 Development Cycle 
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4.2.2 Compiling the Source Program 

In general, use of the PRO/Tool Kit BASIC-PLUS-2 compiler is very 
similar to that of the BASIC-PLUS-2 compiler on RSX systems. The 
compiler qualifiers and command line formats for PRO/Tool Kit 
BASIC-PLUS-2 are the same as those for BASIC-PLUS-2, with the 
exception of those listed in Table 4-1. To invoke the PRO/Tool Kit 
BASIC-PLUS-2 compiler, use the command: 

* BASIC 

Compile your source program using the COMPILE command. The compiler 
checks each line of the source program for errors, returning an 
appropriate message if an error is found. You can correct the program 
as necessary and recompile it. Program compilation produces an object 
module file (filename.OBJ) that can be task built. 

PRO/Tool Kit BASIC-PLUS-2 has its own debugger. To use the debugger 
with your application/ compile your source program using the /DEBUG 
qualifier. To find errors in the BASIC source code, you can debug 
your program when you have completed the task building step. To find 
errors in the application files, and perhaps additional errors in 
BASIC source code, you can debug the application itself, after you 
have built it with the Professional Application Builder (PAB). In 
either case, you can issue commands to the debugger to control and 
monitor program and application execution. 


4.2.3 Generating the Command and Descriptor Files 

After compiling the program, use the BUILD command to generate a 
command file (filename.CMD) and overlay descriptor language file 
(filename.ODL) for your application. The Professional Application 
Builder (PAB) uses these files to define how libraries are referenced 
and to specify special-purpose buffers, logical unit numbers (LUNs), 
and event flags (EFNs). 


4.2.3.1 The PRO/Tool Kit BASIC-PLUS-2 Command File - The PRO/Tool Kit 
BASIC-PLUS-2 compiler generates the following command file for the 
Tool Kit application "TEST1" (comments have been added to describe the 
entries): 


sy:testi/cp=sy:testi/mp 

TASK=task-name 

UNITS = 18 

ASG = TItl3tl5 

asg = sy:5J6:7:8:?:io:ii:i2 

EXTTSK= 952 

CLSTR = RKSRES>POSREStRO 

f DEFINE BUFFER SIZES 


EXTSCT 

EXTSCT 

EXTSCT 

EXTSCT 

EXTSCT 


DM$BUFM540 

FL*BUF:4310 

HL$BUF:3410 
MMiBUF 11000 
«N$BUF:4540 


f dynamic sinslle-choice menu 
? file selection/specification 
t for OLDFIL and NEWFIl. routine 
t help text/menu 
f multi-screen menu 
f static sinsle-choice menu 
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GBLDEF 

GBLDEF 

GBLDEF 

GBLDEF 

GBLDEF 

GBLDEF 

// 


HL$LUN 4 .21 

mn$lun:20 

ms$lijn:i6 

tt$efn:i 

tt$lun:i5 

wc$lun:22 


f DEFINE LUN ASSIGNMENTS 

? help frame file 
i menu frame file 
r message frame file 
r terminal I/O event flas* 
f terminal I/O 

f directory searches for OL.DFIL and NEUFIL 
r routine or callable print services 


Each line in the file specifies a command or option to the task 
builder. You can specify additional options; however, the default 
options supplied in the BASIC CMD file let you access the callable 
routines available on the Professional. See the Tool Kit User 1 s Guide 
and the RSX-11M/M-PLUS Task Builder Manual for more information about 
CMD files. 


4.2.3.2 The PRO/Tool Kit BASIC-PLUS-2 Overlay Descriptor File - The 
PRO/Tool Kit BASIC-PLUS-2 compiler generates the following overlay 
descriptor language file for the Tool Kit application "TEST1": 

♦ ROOT BASIC2-RMSR0T-USER * RMSAL.L 

USER: ♦FCTR SYtTESTt-LIBR 

LIBR: .FCTR LB:C0010053BP20TS/LB 

0LB:COO1OO5DBP2IC1 
0LB:COO1OO53RMSRLX 
.END 

See the Tool Kit User's Guide and the BASIC on RSX-11M/M-PLUS Systems 
manual for more information about ODL files. 


4.2.4 Building the P/OS Task Image 

After you have created the desired CMD and ODL files, use the 
Professional Application Builder (PAB) to create an application task 
image (filename.TSK). Invoke PAB and enter the command file as 
follows: 

$ RUN $PAB 
PAB> 0TEST1 

This creates the task image TEST1.TSK. 

See the Tool Kit User 1 s Guide for complete information on Professional 
Application Builder commands. 


4.2.5 Running and Debugging the Task Image File 

After you create an executable task image, you can run it with the RUN 
command and use the PRO/Tool Kit BASIC-PLUS-2 debugger to debug the 
program. (See your BASIC documentation for more information on the 
debugger.) 

When you execute a task that has been compiled with the /DEBUG 
qualifier, you can debug it by redirecting the debugger output to a 
terminal connected to the printer port on the Professional. (See the 
Tool Kit User 1 s Guide for details.) Use the PRO/Tool Kit BASIC-PLUS-2 
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REDIRECT command to display debugger I/O and issue debugger commands 
on that terminal. Input is accepted from and output goes to the 
printer port. Note that the REDIRECT command does not accept a 
terminal device number. All other I/O, including graphics or forms, 
remains unaffected. 


4.2.6 Writing the Application Installation File 

You must write an installation file (filename.INS) before you can 
install the application on the Professional. The installation file 
for the application "TEST1 M looks like this: 

! PRO Installation file TEST1.INS 
NAME "Testl Application' 

FILE CTEST13TEST1♦TSK/DELETE 
INSTALL CTEST13TEST1*TSK/TA3K 
RUN TEST 1 

Some P/OS services require additional lines in the INS file. See the 
Tool Kit User 1 s Guide for information specific to the service you plan 
to use and for a description of what should go into the INS file. In 
particular, note the differences between applications running under 
P/OS Diskette and those running under P/OS Hard Disk. 


4.2.7 Installing, Running, and Debugging the Application 

Use the P/OS menu structure and Fast Install to install your new 
application. When you execute Fast Install, you are prompted to enter 
a directory name. Enter the name of the directory that contains the 
INS and TSK files (and other required files); note that the name of 
the INS file must be identical to the directory name. Press DO when 
you have entered the directory name. 

Fast Install now prompts you to select a menu group within which to 
install the new application. After you have chosen the menu group, 
you have an opportunity to change both the menu application name and 
the group name. Press DO when you are satisfied with both names. 

Fast Install reports the success or failure of the installation 
process. Refer to the Tool Kit User 1 s Guide for more information. 

When the application has been successfully installed, you can run it 
using the P/OS menu structure. If the BASIC object module was 
compiled with the /DEBUG qualifier, you can also debug the application 
by using the REDIRECT command and a terminal attached to the 
Professional (see Section 4.2.5). 


4.2.8 Running the Application Diskette Builder (ADB) 

When your application is error free, run the Application Diskette 
Builder to create a final diskette. See the Tool Kit User's Guide for 
complete information on Application Diskette Builder commands'! 
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4.3 PRESETTING THE COMPILER ENVIRONMENT WITH AN INITIALIZATION FILE 

To preset the compiler environment, you can use a compiler 
initialization file. The compiler initialization file (called the 
BP2INI file) allows you to override the defaults chosen when PRO/Tool 
Kit BASIC—PLCJS —2 was installed. Thus, you can preset the compiler 
environment to suit your needs. BP2INI files contain compiler 
commands that set defaults for libraries, for COMPILE and BUILD 
commands, for ODL files, and so on. Section 4.3.2 lists the compiler 
commands that are valid in a BP2INI file. 

When you invoke BASIC-PLUS-2, the compiler searches for BP2INI files 
in two locations. First, the compiler searches for a file named 
BP2INI.BP2 in LB: [001002]. If it finds this file, the compiler 
executes the commands in it. Then, the compiler searches for a file 
named BP2INI.BP2 in the current default directory. If it finds this 
file, the compiler executes the commands in it. Note that if the same 
type of command is executed in both files, the command in your current 
default directory BP2INI file overrides the command executed in the 
LB: [001002]BP2INI.BP2 file. 

This scheme allows you great flexibility; you can change defaults for 
every invocation of BASIC-PLUS-2 by modifying the BP2INI file in 
LB: [001002]. And you can set up specialized defaults by keeping 
additional BP2INI files in other directories. 

The next three sections are organized as follows: 

• Section 4.3.1 describes how to create a BP2INI file. 

• Section 4.3.2 describes the commands allowed in a BP2INI file. 

• Section 4.3.3 is a sample BP2INI file. 


4.3.1 Creating a BP2INI File 

Use a text editor to create a BP2INI file for PRO/Tool Kit 
BASIC-PLUS-2, and name the file BP2INI.BP2. You can include the 
commands listed in Section 4.3.2. Each command must appear on a 
separate line. Note that comments are not allowed in the BP2INI file; 
however, you can include blank lines to improve readability. 

To set up the system compiler initialization file, that is, a BP2INI 
file that takes effect each time you invoke PRO/Tool Kit BASIC-PLUS-2, 
you must create a file named BP2INI.BP2 in the LB: [001002] directory. 

Since the compiler searches for a second BP2INI file in the current 
directory, you can create additional BP2INI files in any number of 
directories. The BP2INI file in your directories can contain commands 
that override the commands in the system initialization file 
(BP2INI.BP2 in LB:[001002]) and the commands that make additional 
changes to the compiler environment. 

Note that both the system and current directory initialization files 
are optional. The PRO/Tool Kit BASIC-PLUS-2 installation does not 
produce an initialization file; without one, the compiler environment 
is determined by the installation defaults. 
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You can display the installation defaults by entering the SHOW command 
from within the PRO/Tool Kit BASIC-PLUS-2 environment: 

* BASIC 


PDP-11 BASIC-PLUS-2 V2*3-00 
BASIC2 


SHOW 

PDP-11 BASIC-PLUS-2 V2*3-00 usinS 
ENVIRONMENT INFORMATION: 

Current edit line : 0 
NO Modules loaded 
NO Main module loaded 

DEFAULT DATA TYPE INFORMATION: 
Data type : REAL 
Real size : SINGLE 
Integer size X WORD 
Scale factor : 0 
COMPILATION QUALIFIERS: 

Object 
NO Macro 
Lines 
Warnings 

NO Debus records 
NO Syntax checkins 
FlaS t DeclininS 
Variant : 0 


FPU with NO run support 
RMS FILE ORGANIZATION: 

NO Index 
NO Relative 
Seauential 
NO Virtual 

LISTING FILE INFORMATION: 

NO Source 

NO Cross Reference 
NO Keywords 

60 lines by 132 columns 

BUILD qualifiers: 

NO Dump 
NO Map 

Cluster 

NO I- and D-Space 

Task extend : 512 

RMS ODL file : LB:C1>51RMSRLX 

BP2 Disk lib X LR:T1>53BP2GTS 

BP2 Resident lib : NONE 

RMS Resident lib : RMSRES 


BASIC2 


4.3.2 BP2INI File Commands 


The following commands are allowed in a PRO/Tool Kit BASIC-PLUS-2 
compiler initialization file. They are a subset of PRO/Tool Kit 
BASIC-PLUS-2 compiler commands: 

Command Function 


LOCK 

SCALE 

SET 

SHOW 

BRLRES 


Identical to the SET command 

Sets the scale factor for COMPILE or BUILD 

Sets compiler defaults 

Displays current defaults 

Sets BASIC memory-resident library 


For a complete description of these commands, see your BASIC 
documentation. 


No other commands are allowed. If a BP2INI file includes an illegal 
command, an error message is generated when the compiler is invoked. 
For example, if you try to use the invalid command NEW, you get this 
message: 

? NEW is an Illegal command from the initialization file* 
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4.3.3 Sample BP2INI.BP2 File 

The format of the BP2INI file is a simple list of compiler commands 
that begin in the first column. For example: 

BRLRES BP2V23 

SET /LIST 

SET /DOUBLE/BYTE 

SCALE 4 

SHOW 

This BP2INI.BP2 file presets the compiler environment so that: 

• A source listing is produced (SET /LIST). 

• The default size for all floating-point data is DOUBLE, and 
the default size for all integers is BYTE (SET /DOUBLE/BYTE). 

• The scale factor is set to 4 (SCALE 4). 

• The compiler defaults are displayed when you enter the 
compiler environment (SHOW command). 

If you create this sample file as the system compiler initialization 
file (LB: [001002]BP2INI.BP2), and no BP2INI file exists for your 
current default directory, the following text is displayed whenever 
you invoke the compiler: 


$ BASIC 


PDP-11 BASIC-PLUS-2 V?*3-00 usi 
ENVIRONMENT INFORMATION: 

Current edit line t 0 
NO Modules loaded 
NO Main module loaded 

DEFAULT DATA TYPE INFORMATION: 
Data type X REAL 
Real size : DOUBLE 
Integer size : BYTE 
Scale factor : 4 
COMPILATION QUALIFIERS: 

Object 
NO Macro 
Lines 

NO Debus records 
NO Syntax checkins 
Flas t Declinins 
Variant : 0 


S FPU with NO run support 
RMS FILE ORGANIZATION: 

NO Index 
NO Relative 
Seouential 
NO Virtual 

LISTING FILE INFORMATION: 

Source 

NO Cross Reference 
NO Keywords 

60 lines by 132 columns 
BUILD qualifiers: 

NO Dump 
NO Map 

Cluster 

NO I- and D-space 

Task extend : 512 

RMS 0DL file ** L B : C 1 > 51RMSRL X 

BP2 Disk lib : LB :C1 *53BP2QTS 
BP2 Resident lib : NONE 
RMS Resident lib : RMSRES 


Note the changes from the installation default environment that was 
previously displayed. The defaults for "Real size :", "Integer size 
:", "Scale factor :", and " Source" are changed by the initialization 
file. 


Compiler commands within a BP2INI file function the same as those in 
the compiler environment, with two exceptions: 

• BASIC appends the text "in initialization file" to regular 
error messages to notify you that the error occurred in an 
initialization file. For example: 

flllesal library name specified in initialization file 
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• Commands that normally prompt for an argument do not do so; 
instead, the following error is reported: 

no file specified for command in initialization file 

The contents of BP2INI file are not automatically displayed at the 
terminal. If you want to display the contents of the file, you should 
use the SHOW command as the last command in your file. Thus, each 
time you invoke the compiler, the default settings are displayed. If 
you do not include the SHOW command as the last command in the file, 
the defaults shown do not reflect all the changes produced by the 
file. 

For complete information on the BP2INI file, see the BASIC on 
RSXll-M/M-PLUS Systems manual. 


4.4 PRO/TOOL KIT BASIC-PLUS-2 RUN-TIME ERROR MESSAGES 

PRO/Tool Kit BASIC-PLUS-2 run-time error messages are a subset of 
BASIC-PLUS-2 run-time error messages on RSX systems. The PRO/Tool Kit 
BASIC-PLUS-2 run-time error messages are preceded by a number. If you 
use the ERT$ function to reference an error number that is not in the 
Tool Kit BASIC-PLUS-2 subset, ERT$ returns the following message: 

Can't access LBiC0010021BP2ERR♦ERR or can't find frame <id> 

Frame <id> identifies the error number of the ERT$ you tried to 
reference. 

If the debugger is not present, that is, if the program was not 
compiled with the /DEBUG qualifier, the following notice appears on 
the screen after the error message is displayed: 

Please write down the above message -- press RESUME to continue* 

You must press the RESUME key to clear the screen and continue. 


Table 4-2: PRO/Tool Kit BASIC-PLUS-2 Error Messages 


Number 


Text 


1 

2 

3 

4 

5 

6 

7 

8 

9 

10 
11 
12 

13 

14 

15 
19 


?Bad directory for device 
Plllegal file name 
?Account or device in use 
?No room for user on device 
?Can’t find file or account 
?Not a valid device 
?I/0 channel already open 
?Device not available 
?I/0 channel not open 
?Protection violation 
?End of file on device 
?Fatal system I/O failure 
?User data error on device 
?Device hung or write locked 
?Keyboard wait exhausted 
?Disk block is interlocked 


(Continued on next page) 
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Table 4-2 (Cont.): PRO/Tool Kit BASIC-PLUS-2 Error Messages 


Number Text 


28 ?Programmable ~C trap 

31 ?Illegal byte count for I/O 

34 ?Reserved instruction trap 

35 ?Memory management violation 

43 PVirtual array not on disk 

44 ?Matrix or array too big 

45 ?Virtual array not yet open 

46 Plllegal I/O Channel 

47 ?Line too long 

48 %Floating point error 

50 %Data format error 

51 llnteger error 

52 ?Illegal number 

53 %Illegal argument in LOG 

54 %Imaginary square roots 

55 ?Subscript out of range 

56 ?Can't invert matrix 

57 ?Out of data 

58 ?ON statement out of range 

59 ?Not enough data in record 

60 ?Integer overflow, FOR loop 

61 %Division by 0 

63 7FIELD overflows buffer 

64 ?Not a random access device 

72 7RETURN without GOSUB 

73 7FNEND without function call 

88 7Arguments don’t match 

89 ?Too many arguments 

97 ?Too few arguments 

104 7RESUME and no error 

105 7Redimensioned array 

116 7PRINT USING format error 

126 ?Maximum memory exceeded 

127 %SCALE factor interlock 

130 ?Key not changeable 

131 ?No current record 

132 ?Record has been deleted 

133 ?Illegal usage for device 

134 ?Duplicate key detected 

135 ?Illegal usage 

136 ?Illegal or illogical access 

137 ?Illegal key attributes 

138 ?File is locked 

139 ?Invalid file options 

140 ?Index not initialized 

141 ?Illegal operation 

142 ?Illegal record on file 

143 ?Bad record identifier 

144 ?Invalid key of reference 

145 ?Key size too large 

147 7RECORD number exceeds maximum 

148 ?Bad RECORDSIZE value on OPEN 

149 ?Not at end of file 

150 ?No primary key specified 

151 ?Key field beyond end of record 

152 ?Illogical record accessing 
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DEVELOPING THE APPLICATION 


Table 4-2 (Cont.): PRO/Tool Kit BASIC-PLOS-2 Error Messages 


Number 

Text 

153 

PRecord already exists 

154 

?Record/bucket locked 

155 

PRecord not found 

156 

PSize of record invalid 

157 

PRecord on file too big 

158 

PPrimary key out of sequence 

159 

PKey larger than record 

160 

?File attributes not matched 

161 

PMove overflows buffer 

162 

PCannot open file 

164 

PTerminal format file required 

166 

PNegative fill or string length 

167 

Plllegal record format 

168 

Plllegal ALLOW clause 

170 

PIndex not fully optimized 

171 

PRRV not fully updated 

173 

PInvalid RFA field 

180 

PNo support for op in task 

183 

PREMAP overflows buffer 

184 

%CJnaligned REMAP variable 

185 

PRECORDSIZE overflows MAP buffer 

186 

PImproper error handling 

227 

PString too long 

246 

PError trap needs RESUME 

247 

Plllegal RESUME to subroutine 

248 

Plllegal return from subroutine 

250 

PNot implemented 

251 

PRecursive subroutine call 

252 

PFILE ACP failure 

253 

PDirective error 
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